home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / a_man / cat7 / db.z / db
Encoding:
Text File  |  2002-10-03  |  6.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. DDDDBBBB((((7777PPPP))))                                                                  DDDDBBBB((((7777PPPP))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      db - local name service database
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      /var/ns/lib/libns_db.so
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      The db client library fetches name service data out of an ddddbbbb((((3333BBBB)))) format
  16.      database file on the local host.  This library is meant to be used only
  17.      by the nnnnssssdddd((((1111MMMM)))) daemon to efficiently access local name service data.
  18.  
  19.      The library ////vvvvaaaarrrr////nnnnssss////lllliiiibbbb////lllliiiibbbbnnnnssss____ddddbbbb....ssssoooo is opened by the nnnnssssdddd((((1111MMMM)))) daemon when
  20.      ddddbbbb is listed as the protocol for some map in a nnnnsssssssswwwwiiiittttcccchhhh....ccccoooonnnnffff file.
  21.  
  22.      The library contains code to fetch data from a local db file and present
  23.      it as lines from the configuration file from which it came.  The nsd
  24.      daemon then presents that data in the filesystem mounted under /ns.
  25.  
  26.      Extended attributes in the nnnnsssssssswwwwiiiittttcccchhhh....ccccoooonnnnffff file can be used to control the
  27.      behavior of the db library.  Extended attributes are simply lists of
  28.      key/value pairs attached to each object in the nsd filesystem.  The
  29.      attributes supported in this library are:
  30.  
  31.      ddddoooommmmaaaaiiiinnnn
  32.           This is the domainname given as a parameter to the remote name
  33.           server.  This attribute is typically inherited from the daemon
  34.           depending on the nsswitch.conf file that is being read.  Given the
  35.           configuration file ////vvvvaaaarrrr////nnnnssss////ddddoooommmmaaaaiiiinnnnssss////DDDDOOOOMMMMAAAAIIIINNNNNNNNAAAAMMMMEEEE////nnnnsssssssswwwwiiiittttcccchhhh....ccccoooonnnnffff the
  36.           attribute "domain" is set to DOMAINNAME.  This attribute controls
  37.           which file is used to supply the requested information.  Given a
  38.           domain DOMAINNAME the library would open the file
  39.           ////vvvvaaaarrrr////nnnnssss////ddddoooommmmaaaaiiiinnnnssss////DDDDOOOOMMMMAAAAIIIINNNNNNNNAAAAMMMMEEEE////ttttaaaabbbblllleeee....ddddbbbb.  If the domain attribute is
  40.           unset then the file ////eeeettttcccc////ttttaaaabbbblllleeee....ddddbbbb would be used.  See the
  41.           information about the ttttaaaabbbblllleeee attribute below.  A client system can be
  42.           a member of multiple domains by including multiple instances of the
  43.           ddddbbbb keyword in the nsswitch.conf file like:
  44.                hosts: db(domain=engr) db(domain=corp)
  45.  
  46.      ttttaaaabbbblllleeee
  47.           The ttttaaaabbbblllleeee attribute is typically inherited from the daemon based on
  48.           the line from which this entry occurs in the nsswitch.conf file.  In
  49.           the above example the ttttaaaabbbblllleeee attribute would be set to hhhhoooossssttttssss....bbbbyyyynnnnaaaammmmeeee
  50.           or hhhhoooossssttttssss....bbbbyyyyaaaaddddddddrrrr depending on the context of the request.  This
  51.           attribute is used as the file name containing the db data, with a
  52.           ".db" appended. For the hhhhoooossssttttssss....bbbbyyyynnnnaaaammmmeeee map in the default domain the
  53.           file ////eeeettttcccc////hhhhoooossssttttssss....bbbbyyyynnnnaaaammmmeeee....ddddbbbb would be opened and searched.
  54.  
  55.      kkkkeeeeyyyy  The kkkkeeeeyyyy attribute is used to fetch the data from the db(3B) file.
  56.           It is set by the nsd(1M) daemon, and is used without alteration.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. DDDDBBBB((((7777PPPP))))                                                                  DDDDBBBB((((7777PPPP))))
  71.  
  72.  
  73.  
  74.      ffffiiiilllleeee The ffffiiiilllleeee attribute overrides the domain and table attributes to set
  75.           the name of the file to be opened.  If the file begins with a
  76.           leading '/' then that file is simply opened.  If not, then the
  77.           contents of this attribute are appended to the directory name --
  78.           either ////eeeettttcccc//// for the default domain, or ////vvvvaaaarrrr////nnnnssss////ddddoooommmmaaaaiiiinnnnssss////DDDDOOOOMMMMAAAAIIIINNNNNNNNAAAAMMMMEEEE////
  79.           when the domain attribute is set.
  80.  
  81.      ddddbbbb____hhhhaaaasssshhhh
  82.           The ddddbbbb____hhhhaaaasssshhhh attribute sets the hash type for a Berkeley db file.
  83.           The default is "btree".  The valid choices are btree, hash, and
  84.           recno.   See dbopen(3) for detail on these.
  85.  
  86.      nnnnuuuullllllll____eeeexxxxtttteeeennnndddd____kkkkeeeeyyyy
  87.           The nnnnuuuullllllll____eeeexxxxtttteeeennnndddd____kkkkeeeeyyyy attribute specifies that the null character
  88.           which terminates the key is really part of the key.  Some
  89.           applications (such as sendmail) have historically included the null
  90.           in the key so this attribute provides backward compatibility with
  91.           the old behavior.
  92.  
  93. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  94.      nsd(1M), dbopen(3), nsswitch.conf(4)
  95.      IIIIRRRRIIIIXXXX AAAAddddmmmmiiiinnnn:::: NNNNeeeettttwwwwoooorrrrkkkkiiiinnnngggg aaaannnndddd MMMMaaaaiiiillll
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.